home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / EUMAL604.ZIP / EUMAIL.DOC < prev    next >
Encoding:
Text File  |  1996-04-21  |  14.3 KB  |  310 lines
  1. EUMAIL.DOC                           1                         Revised: 04/21/96
  2.  
  3. The EUMAIL.EXE program does some summarizing  for  the  Eudora  Internet  e-mail
  4. program.
  5.  
  6.  
  7. What is Eudora?
  8.  
  9. Eudora is an excellent Internet  e-mail  program.   It's  put  out  by  QUALCOMM
  10. Incorporated in San Diego California.  The latest version of Eudora Light can be
  11. found on  ftp.qualcomm.com,  in  the  directory  quest/windows/eudora/1.5.   The
  12. Windows freeware user manual can also  be  found  on  ftp.qualcomm.com,  in  the
  13. directory quest/windows/eudora/documentation.
  14.  
  15.  
  16. What files does EUMAIL.EXE create for you?
  17.  
  18. EUMAIL can create three files:
  19.   (1) A dump of your Eudora e-mail data base
  20.   (2) A summary of your Eudora mailboxes and folders
  21.   (3) An ASCII dump of the contents or just the message headers of each of your
  22.       mailboxes
  23.  
  24.  
  25. The e-mail data base:
  26.  
  27. EUMAIL creates a dump of your e-mail data  base.   This  includes  all  of  your
  28. nicknames and comments (the use of comments is heavily recommended).  This is an
  29. ideal file to use the DOS FIND command (or the Wayne Software BFIND command)  to
  30. search through.  A sample of the format:
  31.  
  32. BanBruce      : Bruce Guthrie            <bguthrie@doc.gov>
  33. BanForrest    : Forrest Williams         <fwilliams@doc.gov>
  34. BanJoe        : Joe Correia              jcorreia@doc.gov
  35. BanTravis     : Travis Mayo              <tmayo@doc.gov>
  36. WS_READ       : Billy Rudock             <billy_rudock@notes.seagate.com>
  37.            [2]: Les Ferch                <ferch@cce.ubc.ca>
  38.            [3]: Martin Mossakowski       <mossako@asterix.uni-muenster.de>
  39.            [4]: Tony Vincent             <tonyvinc@iconz.co.nz>
  40. XList         > requests: majordomo@chaos.taylored.com
  41. XList         > msg: SUBSCRIBE X-FILES
  42. XList         > msg: SUBSCRIBE X-FILES-DIGEST
  43. XList         > msg: UNSUBSCRIBE X-FILES
  44. XList         : x-files@chaos.taylored.com
  45.  
  46. The fields are:
  47.   * The nickname you've defined for this user
  48.   * The actual name (if any) of that user
  49.   * The e-mail address for that user
  50.  
  51. Comments are indicated with ">" entries and they appear before the actual entry.
  52.  
  53. Nicknames which define multiple users are sorted by  actual  name  and  then  by
  54. e-mail address.
  55.  
  56.  
  57.  
  58. EUMAIL.DOC                           2                         Revised: 04/21/96
  59.  
  60. The summary of your Eudora mailboxes and folders:
  61.  
  62. EUMAIL creates a summary of all the mailboxes and folders you've created.  These
  63. show the number of messages, the date range, and file size, and what percent  of
  64. total bytes consumed each box accounts for.  A complete dump of what mine looked
  65. like when I ran it:
  66.  
  67. Box/folder name  msgs  earliest -> newest         bytes  % of
  68.                                                         bytes
  69.  
  70. In                 19  02/02/96 -> 03/03/96      75,336    1%
  71. Trash             291  02/15/96 -> 03/03/96     677,407   13%
  72. Out               431  02/24/96 -> 03/03/96     461,383    9%
  73. BMG                17  01/30/96 -> 02/21/96      39,311    1%
  74. Humor              44  01/11/96 -> 03/02/96     154,464    3%
  75. Kevin              25  05/31/95 -> 02/27/96      45,156    1%
  76. Misc               30  02/04/96 -> 03/01/96      63,273    1%
  77. SAAB               44  01/31/96 -> 03/01/96     123,530    2%
  78. SAAB Digests       50  02/22/96 -> 03/02/96   1,925,477   36%
  79. SF-Lovers           3  01/22/96 -> 02/29/96      43,542    1%
  80. SF-News            46  01/17/96 -> 03/01/96     538,093   10%
  81. Simtel              1  12/11/95 -> 12/11/95      15,339    0%
  82. Soniat              7  10/06/95 -> 01/24/96      10,498    0%
  83. System              4  09/28/95 -> 02/21/96      10,080    0%
  84. Wayne              28  01/21/96 -> 02/29/96      70,486    1%
  85. Work                4  02/20/96 -> 02/22/96       5,526    0%
  86. WWW site           25  01/25/96 -> 02/28/96      55,695    1%
  87. X-Files            73  02/03/96 -> 03/02/96     248,217    5%
  88. Keep
  89.   Keep-Other       16  12/11/94 -> 01/04/96      46,881    1%
  90.   Keep-Ithaca      12  12/10/95 -> 02/07/96      20,651    0%
  91.   Keep-Pamela      24  12/21/95 -> 02/21/96      74,663    1%
  92.   Keep-SAAB        10  01/21/96 -> 02/16/96      17,836    0%
  93.   Keep-Wayne       20  10/22/93 -> 02/15/96      64,244    1%
  94.   Keep-X-Folk      21  12/01/95 -> 02/21/96      78,818    1%
  95. Listers
  96.   Chigs            11  02/11/96 -> 02/25/96      23,518    0%
  97.   Debbie           13  02/03/96 -> 02/29/96      26,948    1%
  98.   Ithaca           83  02/08/96 -> 03/01/96     143,692    3%
  99.   Munchkyn         28  12/15/95 -> 02/29/96      68,709    1%
  100.   Pamela           45  02/18/96 -> 03/02/96      70,790    1%
  101.   Simon            32  02/26/96 -> 03/03/96      47,685    1%
  102.   SpaceGirl        54  02/10/96 -> 03/02/96      92,230    2%
  103.   Wendy            12  02/08/96 -> 02/25/96      17,587    0%
  104.  
  105.   32 boxes      1,523           ->            5,357,065  100%
  106.  
  107.  
  108. EUMAIL.DOC                           3                         Revised: 04/21/96
  109.  
  110. The program, by default, will automatically display  information  about  "large"
  111. boxes based on a combination of three  criteria.   Lines  above  will  be  shown
  112. on-screen for any box which exceeds any of the three criteria.  The three are:
  113.  
  114.   * The total number of messages in the box (/n parameter)
  115.   * The total number of (thousand) bytes in the box (/nK parameter)
  116.   * The percentage of total bytes that that box accounts for (/n% parameter)
  117.  
  118. The defaults are /100, /100K, and /5%.
  119.  
  120. If you'd like to turn off the on-screen display entirely, you can specify the /Q
  121. parameter.  If you'd like the criteria to be based on one or two criteria  only,
  122. specify an unusually large value for the other parameter(s) (e.g. /30000K).
  123.  
  124. Using an INI file for the criteria (see later) is always an option.
  125.  
  126.  
  127. ASCII dumps:
  128.  
  129. The EUMAIL program will dump the contents of all of your e-mail boxes for you if
  130. you'd like.  (Optionally, you can specify that  it  only  dump  mailboxes  whose
  131. names begin with a certain character string.) In so doing, it creates a table of
  132. contents and divided each article with a page  eject  for  you.   The  table  of
  133. contents looks something like this:
  134.  
  135. Dump of file E:\NMAA\MAIL\In.mbx Processed on 03-31-1996 at 11:55:00
  136.  
  137. Contents:
  138.  
  139.    1 hans.schrader@geol.uib.no                07:05 AM 2/2/96 MET       47 lines
  140.      Dirtotal changed
  141.    2 T. R. Halvorson                          09:14 AM 2/23/96 EST      53 lines
  142.      Re: HTMSTRIP
  143.    3 T. R. Halvorson                          09:15 AM 2/24/96 EST      22 lines
  144.      Re: HTMSTRIP
  145.  
  146. The ASCII message dump is requested with the /DUMP parameter.  A  separate  dump
  147. file (with an extension of *.DMP) will be created for each mailbox.  These  dump
  148. files will be in your mailbox storage subdirectories.
  149.  
  150. You may want to PKZIP one or more of the *.DMP files and then move them  out  of
  151. your Eudora subdirectories, perhaps  storing  them  on  a  floppy  diskette  for
  152. purposes of retaining them.  As long as you are reasonably  sure  you  will  not
  153. want to be doing responses or something in Eudora, you can delete  the  messages
  154. from the mailboxes you save this way.
  155.  
  156. Personally, I save all of my outgoing messages for some reason.  I then save  an
  157. ASCII version of what I sent, compress it, and then delete them en masse.
  158.  
  159. If you'd like, you can get just the table of contents for the messages and  skip
  160. the actual dump of the messages themselves.  This can be achieved by  using  the
  161. /HEADER option.
  162.  
  163. If you later decide you want to kill off all of the *.DMP  files,  pass  in  the
  164. parameter /KILLDUMP and it will take care of them for you.
  165.  
  166.  
  167. EUMAIL.DOC                           4                         Revised: 04/21/96
  168.  
  169. Specifying parameters:
  170.  
  171. Parameters for this program can be set in the following ways.  The last  setting
  172. encountered always wins:
  173.   - Read from an *.INI file (see BRUCEINI.DOC file),
  174.   - Through the use of an environmental variable (SET EUMAIL=whatever), or
  175.   - From the command line (see "Syntax" below)
  176.  
  177.  
  178. Syntax:
  179.  
  180.     EUMAIL /Eeudora_sub [ /Ooutput_sub ] [ /NL=filename | /-NL ] [ /REPEAT ]
  181.       [ /NS=filename | /-NS ] [ /n ] [ /nK ] [ /n% ]
  182.       [ /DUMP | /HEADERS | /KILLDUMP ] [ domain ]
  183.       [ /Q ] [ /Iinitfile | /-I ] [ /? ]
  184.  
  185. where:
  186.  
  187. "/Eeudora_sub" is the location where you installed Eudora.  There is no  default
  188. for this parameter; it must be specified.  The  use  of  a  EUMAIL.INI  file  is
  189. heavily recommended to set this parameter (see BRUCEINI.DOC).
  190.  
  191. "/Ooutput_sub" is the subdirectory in which you want to  write  the  two  output
  192. files.  This subdirectory must exist already.  It defaults to /OC:\TEMP.  Again,
  193. the use of a EUMAIL.INI file is heavily recommended (see BRUCEINI.DOC).
  194.  
  195. "/NL=filename" specifies the filename that the nickname listing is to go to.  If
  196. no drive/path information is specified,  this  file  will  be  written  to  your
  197. /Ooutput_sub specification.  Otherwise, the name will override the  /Ooutput_sub
  198. specification.  Saying "/-NL" or "/NL="  without  any  filename  indicator  will
  199. suppress  the  creation  of  the  nicknames  file   altogether.    Defaults   to
  200. /NL=EUMAIL.TXT.
  201.  
  202. "/-NL" suppresses the creation of the nickname file entirely.
  203.  
  204. "/REPEAT" says to repeat the names of the nicknames  when  they're  listed.   It
  205. looks better if you don't repeat them but if you use something like FIND on  the
  206. file, you might want to have them repeating.  Initially defaults to /-REPEAT.
  207.  
  208. "/-REPEAT" is the opposite of "/REPEAT".  The name of the nickname only  appears
  209. once even if it contains five e-mail addresses.  There  very  first  example  in
  210. this documentation shows the  output  with  /-REPEAT.   This  is  initially  the
  211. default.
  212.  
  213. "/NS=filename" specifies the filename that the mailbox/folder summary listing is
  214. to go to.  If no drive/path information is specified, this file will be  written
  215. to your /Ooutput_sub specification.   Otherwise,  the  name  will  override  the
  216. /Ooutput_sub specification.   Saying  "/-NS"  or  "/NS="  without  any  filename
  217. indicator will suppress the listing of  the  summary  altogether.   Defaults  to
  218. /NS=EUMAIL.BOX.
  219.  
  220. "/-NS" suppresses the creation of the mailbox summary file entirely.
  221.  
  222.  
  223. EUMAIL.DOC                           5                         Revised: 04/21/96
  224.  
  225. "/n" specifies that any mailbox with more than "n" entries is to be indicated on
  226. the screen when the program runs.  The test for this is  done  independently  of
  227. the tests for the number or entries or the absolute filesize test; any box  with
  228. more than /n message or with a filesize bigger than /nK or a share of more  than
  229. /n% will be displayed unless /Q is specified.  Defaults to /100.
  230.  
  231. "/nK" specifies that any mailbox with more than "n" thousand (K) bytes is to  be
  232. indicated on the screen when the program  runs.   The  test  for  this  is  done
  233. independently of the tests for the number or entries or  the  absolute  filesize
  234. test; any box with more than /n message or with a filesize bigger than /nK or  a
  235. share of more than /n% will be displayed unless /Q is  specified.   Defaults  to
  236. /100K.
  237.  
  238. "/n%" specifies that any mailbox with more than "n" percentage (%) of the  total
  239. bytes used by all stored mail is to be shown on  the  screen  when  the  program
  240. runs.  The test for this is done independently of the tests for  the  number  or
  241. entries or the absolute filesize test; any box with more than /n message or with
  242. a filesize bigger than /nK or a share of more than /n% will be displayed  unless
  243. /Q is specified.  Defaults to /5%.
  244.  
  245. "/DUMP" says to dump the contents of the  mailboxes  out  as  plain  ASCII  text
  246. documents.  The program will also add a table of contents in front of each  dump
  247. for you.  The dump files will be the name  of  the  folder  with  a  *.DMP  file
  248. extension.  Note that the messages will appear in the order they  show  up  when
  249. you view them on the screen and you may want to re-sort them all first. Defaults
  250. to /-DUMP (don't create the dump files).
  251.  
  252. "/HEADERS" says to write out the message headers only, not the actual  messages.
  253. The header files will be the name of the folder with a *.DMP file extension.
  254.  
  255. "/KILLDUMP" deletes any *.DMP files it finds.  This is used if you later  decide
  256. you don't want any of the *.DMP files around or if you've already moved out  the
  257. ones you need and you no longer want the rest of them around.
  258.  
  259. "domain" restricts /DUMP and /HEADERS processing to only those files whose names
  260. begin with a particular character string.  As an example, if you  just  want  to
  261. dump the "Out" mailbox, pass in "OUT".  Note that  this  will  also  dump  other
  262. mailboxes whose names begin with "OUT".  By default, all mailboxes are dumped if
  263. any are.
  264.  
  265. "/Q" says that no individual mailboxes are to be indicated on  the  screen  when
  266. the program runs.  This ignores any /n, /nK, or /n% settings.
  267.  
  268. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  269. The file specification *must* contain a period.  Initfiles are described in  the
  270. BRUCEINI.DOC file.  Initially defaults to "/IEUMAIL.INI".
  271.  
  272. "/INULL" says to skip loading the initialization file.
  273.  
  274. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  275.  
  276.  
  277.  
  278. EUMAIL.DOC                           6                         Revised: 04/21/96
  279.  
  280. Author:
  281.  
  282. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  283. and redistribution provided relevant documentation is kept with the program,  no
  284. changes are made to the program or documentation, and it  is  not  bundled  with
  285. commercial programs or charged for separately.  People who need to bundle it  in
  286. for-sale packages must pay a $50 registration fee to  "Wayne  Software"  at  the
  287. following address.
  288.  
  289. Additional information about this and other Wayne Software programs can be found
  290. in the file BRUCEymm.DOC which should be included  in  the  original  ZIP  file.
  291. ("ymm" is replaced by the last digit of the year and the two digit month of  the
  292. release.  BRUCE603.DOC came out in March 1996.  This same naming  convention  is
  293. used in naming the ZIP file that this program was  included  in.)  Comments  and
  294. suggestions can also be sent to:
  295.  
  296.                 Bruce Guthrie
  297.                 Wayne Software
  298.                 113 Sheffield St.
  299.                 Silver Spring, MD 20910
  300.  
  301.                 fax: (301) 588-8986
  302.                 e-mail: bguthrie@nmaa.org
  303.                 http://hjs.geol.uib.no/guthrie/
  304.  
  305. See BRUCEymm.DOC file for additional contact information.
  306.  
  307. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  308.  
  309. 
  310.